home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / bgqwkb26.zip / BGQWK.DOC next >
Text File  |  1991-12-29  |  46KB  |  894 lines

  1.  
  2.               VOICE               B.J. GUILLOT               MODEM
  3.          (713) 893-9123       2611 RUSHWOOD CIRCLE      (713) 893-9124
  4.                             HOUSTON TEXAS 77067-1941
  5.  
  6.             Copyright B.J. Guillot 1991-1992.  All Rights Reserved.
  7.  
  8.          =============================================================
  9.          BGQWK 1.0 beta 19                                   29 DEC 91
  10.          =============================================================
  11.  
  12.                          Dedicated to Gene Roddenberry
  13.                                   1921-1991
  14.  
  15.          -------------------------------------------------------------
  16.          ABSTRACT
  17.          -------------------------------------------------------------
  18.  
  19.          BGQWK has two modes of operation.  When used as a door, users can
  20.          prepare universal QWK mail packets online and upload REP reply
  21.          packets.  When used in prepack mode, BGQWK creates a specific
  22.          user's QWK packet offline for later downloading through GT Power.
  23.  
  24.          BGQWK can presently be used with GT 15.50, 16.00 and 17.00 and
  25.          works just great on LAN systems.
  26.  
  27.          -------------------------------------------------------------
  28.          INCLUDED FILES
  29.          -------------------------------------------------------------
  30.  
  31.          1.    BGQWK.DOC -- documentation
  32.  
  33.          2.    BGQWK.HLP -- help file shown to users when in bgqwk door
  34.  
  35.          3.   XT-EXE.ZIP  ( you will have the XT-EXE or AT-EXE in your ZIP )
  36.             ------------
  37.                bgqwk.exe -- 8088 version
  38.              utihigh.exe -- 8088 version
  39.             utiexprt.exe -- 8088 version
  40.             utiimprt.exe -- 8088 version
  41.  
  42.          3.   AT-EXE.ZIP
  43.             ------------
  44.                bgqwk.exe -- 80286+ version
  45.              utihigh.exe -- 80286+ version
  46.             utiexprt.exe -- 80286+ version
  47.             utiimprt.exe -- 80286+ version
  48.             ------------
  49.  
  50.          4. EXAMPLES.ZIP
  51.             ------------
  52.                   gt.bat -- example for running prepack and qwk network
  53.             schedule.bbs -- example for running prepack and qwk network
  54.               gtddir.bbs -- how to set bgqwk as a door
  55.              gtdoors.bbs -- door screen shown to users on board
  56.              gtdoor1.bat -- batch file to run bgqwk on a ram disk
  57.              gtdoor2.bat -- batch file to run bgqwk on a hard drive
  58.                bgqwk.cnf -- example configuration file
  59.                 tnet.cfg -- example tnet configuration file
  60.               c-tech.cfg -- example to qwk network off of computech bbs
  61.               c-tech.scr -- script to call computech bbs for qwk network
  62.               c-tech.bat -- performs the work for gt network
  63.               hopper.cfg -- example to qwk network off of ed hopper's bbs
  64.               hopper.scr -- script to call ed hopper's bbs for qwk network
  65.               hopper.bat -- performs the work for texasnet
  66.  
  67.          5. REGISTER.FRM -- registration form
  68.  
  69.          -------------------------------------------------------------
  70.          CONFIGURATION
  71.          -------------------------------------------------------------
  72.  
  73.          BGQWK requires a configuration file in order to run.  This file
  74.          may be placed in the GTPATH or BBS/CBS directories.  In order to
  75.          explain the configuration with ease, take a look at this example:
  76.  
  77. id=TRANQUIL
  78. sn=B.J. Guillot
  79. bn=Tranquility Base
  80. bc=Houston, Texas
  81. bp=713-893-9124
  82. up=C:\GT\UPLOADS
  83. we=C:\GT\BBSFILE\GTWELCOM.CBS
  84. ne=C:\GT\BBSFILE\GTBULLET.CBS
  85. by=C:\GT\BBSFILE\GTBYE.CBS
  86. ma=100
  87. mp=1000
  88. ns=John Doe/gt
  89. ns=Node Houston/tx
  90. ns=Jimmy Dean/rn gt
  91. ----+---+------------+[xx=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx]
  92. 000 | z | Main Board | lo=D:\MAIL\GENERAL
  93. 045 | z | General    | tx=D:\MAIL\TNET001,P
  94. 046 | z | Aggies     | tx=D:\MAIL\TNET003,P
  95. 047 | z | Buy/Sell   | tx=D:\MAIL\TNET004,P
  96. 048 | z | Politics   | tx=D:\MAIL\TNET005,P
  97. 049 | z | Singles    | tx=D:\MAIL\TNET006,PA
  98. 050 | 0 | Admin      | tx=D:\MAIL\TNET002,P
  99. 005 | z | Common     | rn=D:\MAIL\RNET004
  100. 038 | z | Faxmail    | rn=D:\MAIL\RNET278
  101. 051 | z | Global     | rn=D:\MAIL\RNET082
  102. 037 | z | Rime News  | rn=D:\MAIL\RNET200,R
  103. 023 | z | Rime Users | rn=D:\MAIL\RNET104
  104. 052 | z | Uplink     | rn=D:\MAIL\RNET024
  105. 001 | z | Ansi Art   | rn=D:\MAIL\RNET109
  106. 002 | z | Assembler  | rn=D:\MAIL\RNET135
  107. 003 | z | Astronomy  | rn=D:\MAIL\RNET088
  108. 004 | z | C          | rn=D:\MAIL\RNET100
  109. 006 | z | Comp Tech  | rn=D:\MAIL\RNET006
  110. 012 | z | Cult TV    | rn=D:\MAIL\RNET245
  111. 007 | z | Debate     | rn=D:\MAIL\RNET003
  112. 008 | z | Doctor Who | rn=D:\MAIL\RNET116
  113. 009 | z | Engineer   | rn=D:\MAIL\RNET108
  114. 010 | z | Entertain  | rn=D:\MAIL\RNET016
  115. 011 | z | For Sale   | rn=D:\MAIL\RNET002
  116. 013 | z | Fractals   | rn=D:\MAIL\RNET148
  117. 016 | z | Hard Disk  | rn=D:\MAIL\RNET014
  118. 017 | z | Ham Radio  | rn=D:\MAIL\RNET015
  119. 018 | z | LAN        | rn=D:\MAIL\RNET017
  120. 019 | z | Offline    | rn=D:\MAIL\RNET264
  121. 020 | z | Pascal     | rn=D:\MAIL\RNET097
  122. 021 | z | Program'ng | rn=D:\MAIL\RNET010
  123. 022 | z | QuickBasic | rn=D:\MAIL\RNET099
  124. 024 | z | Religion   | rn=D:\MAIL\RNET076
  125. 025 | z | Sci/Tech   | rn=D:\MAIL\RNET083
  126. 026 | z | Sci/Fi     | rn=D:\MAIL\RNET030
  127. 027 | z | Shareware  | rn=D:\MAIL\RNET056
  128. 035 | z | SLMR       | rn=D:\MAIL\RNET260
  129. 028 | z | Star Trek  | rn=D:\MAIL\RNET101
  130. 029 | z | Strange    | rn=D:\MAIL\RNET179
  131. 030 | z | Tandy      | rn=D:\MAIL\RNET129
  132. 031 | z | USR/HST    | rn=D:\MAIL\RNET023
  133. 032 | z | Video Tech | rn=D:\MAIL\RNET192
  134. 033 | z | Windows    | rn=D:\MAIL\RNET044
  135. 034 | z | Wire Wrap  | rn=D:\MAIL\RNET199
  136. 014 | 0 | Admin      | rn=D:\MAIL\RNET025
  137. 036 | 0 | Sysops     | rn=D:\MAIL\RNET001
  138. 015 | z | Gfx Proj   | rn=D:\MAIL\RNET261
  139. 040 | 0 | Netmail    | lo=D:\MAIL\NETMAIL,N
  140. 041 | z | AnsiArt    | gt=D:\MAIL\E10-037,P
  141. 039 | z | Bg Qwk     | gt=D:\MAIL\E02-758,P
  142. 042 | z | GT Power   | gt=D:\MAIL\E00-001,P
  143. 043 | 0 | GT Beta    | gt=d:\MAIL\E01-009,P
  144. 044 | 0 | Hou Chat   | gt=D:\MAIL\E20-002,P
  145.  
  146.          Let's go over the above file one step at a time.
  147.  
  148.          ID=  This is what will be used as your board "id".  It can be
  149.               up to eight characters long.  If omitted, the default "id"
  150.               will be "NONAME".
  151.  
  152.          SN=  This is what will be used as the sysop's name.  This too is
  153.               optional, and if not used, will default to "Sysop", which
  154.               doesn't do much for you.  When users enter messages to
  155.               "Sysop" through their QWK reader, if this is used, the name
  156.               will be translated to the name specified here.
  157.  
  158.          BN=  This is where the name of your board goes.  If omitted, the
  159.               default is "NONAME".
  160.  
  161.          BC=  This is where the city and state of your board goes.  If
  162.               omitted, the default is "Planet, Earth".
  163.  
  164.          BP=  This is where the phone number of your board goes.  If
  165.               omitted, the default is "000-000-0000".
  166.  
  167.          UP=  BGQWK will create, on request by the user, a list of new
  168.               files available on the board since their last file scan.
  169.               If you wish to specify a different directory to scan for
  170.               files, this is where do you do it.  If this is omitted, the
  171.               directory to be checked for files will be taken out of the
  172.               GT.CNF file (from directive UP=).
  173.  
  174.          WE=  BGQWK will create, on request by the user, a WELCOME file to
  175.               be displayed when reading their packet (depending upon the
  176.               software they are using).  If this is omitted, BGQWK will use
  177.               the GTWELCOM.CBS file found in your GTPATH or BBS/CBS
  178.               directory as the WELCOME file.  If another file is specified,
  179.               it will be used as the WELCOME file.
  180.  
  181.          NE=  BGQWK will create, on request by the user, a NEWS file to be
  182.               displayed when reading their packet (depending upon the
  183.               software they are using).  If this is omitted, BGQWK will use
  184.               the GTBULLET.CBS file found in your GTPATH or BBS/CBS
  185.               directory as the NEWS file.  If another file is specified, it
  186.               will be used as the NEWS file.
  187.  
  188.          BY=  BGQWK will create, on request by the user, a GOODBYE file to
  189.               be displayed when reading their packet (depending upon the
  190.               software they are using).  If this is omitted, BGQWK will use
  191.               the GTBYE.CBS file found in your GTPATH or BBS/CBS directory
  192.               as the GOODBYE file.  If another file is specified, it will
  193.               be used as the GOODBYE file.
  194.  
  195.          MA=  As the sysop, you can specify the maximum messages per
  196.               conference a user can download.  The user can also select how
  197.               many maximum messages per conference in the door, but will
  198.               never be able to override the limit specified here.  If this
  199.               is omitted, the maximum will be set to 200.
  200.  
  201.          MP=  As the sysop, you can specify the maximum messages per packet
  202.               a user can download.  The user can also select how many
  203.               maximum messages per packet in the door, but will never be
  204.               able to override the limit specified here.  If omitted, the
  205.               maximum will be set to 2000.
  206.  
  207.          NS=  Please see the NET STATUS section in this documentation.
  208.  
  209. ----+---+------------+[xx=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx]
  210.  
  211.          The line that seperates the configuration information from the
  212.          conference information is the above.  This is completely optional
  213.          and may be removed.  Its only purpose to to provide a ruler for
  214.          the conference information.
  215.  
  216.             ┌─────────────── conference name
  217.             │           ┌─── net id  ┌─── conference path
  218. 000 | z | Main Board | lo=D:\MAIL\GENERAL
  219. 045 | z | General    | tx=D:\MAIL\TNET001,P
  220. 046 | z | Aggies     | tx=D:\MAIL\TNET003,R
  221. 047 | z | Buy/Sell   | tx=D:\MAIL\TNET004,P
  222. 048 | z | Politics   | tx=D:\MAIL\TNET005,P
  223. 049 | z | Singles    | tx=D:\MAIL\TNET006,PA
  224. 050 | 0 | Admin      | tx=D:\MAIL\TNET002,P
  225. 005 | z | Common     | rn=D:\MAIL\RNET004 │
  226. 038 | z | Faxmail    | rn=D:\MAIL\RNET278 └─── conference options
  227.  │    └─── access level
  228.  └──────── conference number
  229.  
  230.          The remaining part of the BGQWK.CNF file consists of the
  231.          conference information.  Every confernece on your board that you
  232.          wish users to have QWK access to _must be_ configure.
  233.  
  234.          Please note that you do not have to configure every conference on
  235.          your board.  Just the ones you wish users to have access to in the
  236.          door--with one exception--you _must_ have the main message base
  237.          conference configured (the conference number will not be of
  238.          consequence).  Remember, the main conference is the one that GT
  239.          pops up by default when users login (the conference specified by
  240.          the MP= directive in GT.CNF).
  241.  
  242.          CONFERENCE NUMBER
  243.          -----------------
  244.          The conference number is a very important part of this file.
  245.          Please note that the numbers do not have to go in order, but if
  246.          you choose to do it that way, be sure to check for duplicate
  247.          numbers.  If BGQWK finds a conference with a duplicate number, it
  248.          will abort with an error message and return to the board.
  249.  
  250.          A maximum of 510 conferences can be used by BGQWK (conferences
  251.          numbers 0 to 509).
  252.  
  253.          Once you have choosen a conference number for a particular
  254.          conference, I _highly_ recommend you keep it that way.  Do _not_
  255.          shift the conference numbers around.  The conference numbers must
  256.          be static, they must stay in place.  When users upload replies
  257.          through BGQWK, the MSG file header instead of the REP packet
  258.          stores the conference number that was used when they originally
  259.          replied to the message.  If a user wrote that reply a week ago and
  260.          is just now uploading the packet, if you changed the message base
  261.          numbers, their messages will be sent into the wrong conference.
  262.          You wouldn't want, say, someone's replies from a sexual oriented
  263.          conference to be posted into a religion conference, would you?
  264.  
  265.          In fact, because of conference number, that is another reason why
  266.          information cannot be read out of the GTMDIR.BBS file.  GT's
  267.          message base numbers are dynamic.  They change depending on access
  268.          level or whenever you insert a message base between another one.
  269.          That is unacceptable in the QWK format.
  270.  
  271.          Let's have a little discussion concerning the dos and don'ts of
  272.          conference numbers in this file.  Say you have conferences 0 to
  273.          46.  You wish to delete conference 12 because you don't carry it
  274.          anymore.  No problem.  Just load up your editor and zap that
  275.          line.  Conference numbers so not have to be sequential.  There can
  276.          be big gaps between numbers.  The QWK readers don't care about
  277.          that.  But say you are adding a conference that same day.  Since
  278.          you have a space open at 12, you think about using 12 as the
  279.          conference number.  Wrong!  Make it conference 47.  Why?  Well,
  280.          again, what if a user was using that conference and is going to
  281.          upload some replies tomorrow, they will be posted into the wrong
  282.          conference.  And, as I said before, I don't think you want to mess
  283.          with the hassle of that.  If you make the new conference 47 and
  284.          leave 12 blank for now, that would be fine.
  285.  
  286.          Now, say you pick up another conference a few weeks down the road.
  287.          You don't know whether to assign it number 12 or 48.  Since so
  288.          much time has passed, I doubt users will have any replies waiting
  289.          to go into the conference, so I would just toss a coin.  It
  290.          doesn't really matter after that.  It's your decision then.
  291.  
  292.          Conference numbers must be padded, to the left, with zeros.  They
  293.          are only padded in the configuration file--no where else.  This is
  294.          done so that the sysop remembers that BGQWK.CNF has a definite
  295.          format and can not be changed.  Do not take out the pipe bars, |,
  296.          between lines.  If you do, BGQWK will inform you that the format
  297.          has been tampered with and will abort back to the board.
  298.  
  299.          CONFERENCE NAME
  300.          ---------------
  301.          Please note that the conference name is limited to ten characters.
  302.          That's all that the QWK format is able to support.  You might be
  303.          asking "Why don't you pull the information out of GTMDIR.BBS?"
  304.          right about this time.  There are several reasons for not doing
  305.          this.  The conference name limit of ten characters is one.  If I
  306.          pulled the information from the GTMDIR.BBS file, I would have to
  307.          truncate the description to only ten characters long.  I would
  308.          much rather give the sysop the option of naming the conference
  309.          because he or she can get the meaning across much more by
  310.          abbreviating than by truncation.
  311.  
  312.          ACCESS LEVEL
  313.          ------------
  314.          This part is pretty much self-explantory.  The access levels work
  315.          the same way they do in GT.  BGQWK pulls the users access level
  316.          from the USER.CTL file rather than the GTUSER.BBS file.  If the
  317.          user does not possess the minimum access level required to access
  318.          a specific conference, that conference selection will not be shown
  319.          to the user.
  320.  
  321.          NET ID
  322.          ------
  323.          This will be discussed further in the NET STATUS section of this
  324.          documentation, but it is also a useful tool for the users in
  325.          BGQWK.  The two letter net id plus the equal sign is optional and
  326.          may be left out of the BGQWK.CNF file for specific conferences.
  327.          If that is done, BGQWK assumes the conference has a net id of
  328.          "LO", local conference.
  329.  
  330.          The net id's must be two letters and only two letters.
  331.  
  332.          On my board, I have the following net id's set up: LO for Local,
  333.          RN for RelayNet, GT for GT Network, and TX for TexasNet.  When the
  334.          users select their conferences through BGQWK, they have the option
  335.          of listing all conferences or listing only the conferences from a
  336.          particular network.  Say they are interested just in TexasNet, for
  337.          instance.  They can list only the six or seven TexasNet
  338.          conferences and not be bothered with all the others.  The net id's
  339.          work similiar to the message base "boards" in GT 17.00.
  340.  
  341.          CONFERENCE PATH
  342.          ---------------
  343.          The path is represented in the same manner that it is represented
  344.          in the GTMDIR.BBS file.  You do not need to input a trailing
  345.          backslash or the \GTMSGS directory.  BGQWK handles that
  346.          automatically.
  347.  
  348.          CONFERENCE OPTIONS
  349.          ------------------
  350.          You specify conference options right after the conference path
  351.          followed by a comma.  These are completly optional and can be
  352.          omitted.  Here is a list of currently supported options:
  353.  
  354.          G,*  Conference is a guest or application only conference.  If
  355.               specified, when a user tries to join this conference, they
  356.               will not be able to download and mail until the sysop
  357.               offically "joins" them into the base.  BGQWK displays a
  358.               "pending" indicator to the user.
  359.  
  360.          A,=  Conference is access level exclusive.  Even if a user has an
  361.               access level high enough to view the conference, if they
  362.               don't have the _same_ access level specified as the
  363.               conference access level, they will _not_ be given access to
  364.               that conference.
  365.  
  366.          N,~  Conference is a GT netmail conference.  To send netmail
  367.               messages, it requires netmail credits.  Because QWK readers
  368.               do not know about GT and the way it's netmail system
  369.               operates, the user, if he or she wishes to send a true
  370.               netmail message, must enter the node/net id as the first line
  371.               of the message.  Both the net and the node must be padded to
  372.               the left with zeros.  Example message text:
  373.  
  374.                    001/070
  375.                    Hello, Russell.  Just testing netmail!
  376.  
  377.                    .DX
  378.  
  379.                    Regards,
  380.                    B.J. Guillot
  381.  
  382.               BGQWK will intercept the "001/070" and change the message
  383.               header to reflect a netmail message to that destination.
  384.  
  385.               Another thing to note is that netmail messages can be placed
  386.               in _any_ conference.  If BGQWK senses a xxx/yyy line as the
  387.               first line of any message uploaded, it will route it to the
  388.               netmail conference (identified with the N or ~ conference
  389.               option).
  390.  
  391.               If a user tries to use a "dot" command in netmail, the "dot"
  392.               will be turned into an asterick _unless_ that user is granted
  393.               sysop authorities.  In my sample message above, if I did not
  394.               have sysop authorities (SY access in the GTUSER.BBS file),
  395.               the .DX would change to *DX so the GT netmail software would
  396.               not process it.
  397.  
  398.          P,^  Conference is a public message area _only_.  Private messages
  399.               are not permitted.  You will most likely want this flag on
  400.               any GT Network conferences.  Because RelayNet can handle
  401.               private messages, there is no need to use it on RIME
  402.               conferences.
  403.  
  404.          R,<  Conference is a read _only_ conference.  No messages may be
  405.               entered, period.
  406.  
  407.          X,$  Conference is private _only_.  No public messages are
  408.               permitted.
  409.  
  410.          S    Conference is 7 bit only.  Any 8 bit characters will be
  411.               stripped of their 8 bit.  This option is useful for FidoNet
  412.               conferences or UseNet conferences where 8 bit characters are
  413.               big bad and naughty.  Otherwise, I would not recommend using
  414.               this option.
  415.  
  416.          Please note that many of the above options have two different
  417.          characters that do the job.  For example, P and ^ both mean public
  418.          message area only.  I did this for the people who know and love
  419.          GT's traditional message flag set.  Since I always get confused
  420.          with the characters, I just included the letter options for other
  421.          people like me.
  422.  
  423.          Also, you can use more than one option per conference.  However,
  424.          be sure to to use any that "cancel the other out".  For example,
  425.          you might not want a conference to be public only and private only.
  426.          BGQWK might through a fit!
  427.  
  428.          -------------------------------------------------------------
  429.          After you have spent forever and a day typing your configuration
  430.          file <grin>, you're almost ready to begin!  However, listen to
  431.          this recommendation closely ...  You may want to only enter
  432.          conference data for ten conferences, make sure BGQWK runs, and
  433.          then type the rest.  You don't want to be stuck entering the wrong
  434.          format for three echos, do you?
  435.          -------------------------------------------------------------
  436.  
  437.          -------------------------------------------------------------
  438.          COMMAND LINE OPTIONS AND PARAMETERS
  439.          -------------------------------------------------------------
  440.  
  441.          BGQWK requires at least two parameters in order to run.  The two
  442.          parameters are the command line options and the drive which BGQWK
  443.          is expected to work on.  Example:
  444.  
  445.               bgqwk mgk f:
  446.  
  447.          The first paramter batch contain specfic options for the way in
  448.          which BGQWK operates.  The "f:" means work on drive F: will be
  449.          used for the work directory.
  450.  
  451.          THE WORK DRIVE
  452.          --------------
  453.          You might be wondering why the door requires a work drive to be
  454.          specified in order to run?  Well, when preparing QWK packets, an
  455.          enormous amount of space is sometimes required.  BGQWK may need
  456.          several megabytes to work with depending on how many messages you
  457.          allow the user to download and how many messages the user chooses
  458.          to download.  Don't worry about running out of space, though.
  459.          BGQWK will try its best not to eat all the space at once.
  460.  
  461.          You may want to place two doors for BGQWK on your system.  This is
  462.          the way mine is set up.  I have one door for BGQWK on a RAM disk
  463.          and one door for BGQWK on a HD.  My RAMdisk only supports one
  464.          megabyte, but many users don't download packets much larger than
  465.          100K most of the time, so they want to access the speed that a
  466.          RAMdisk possess when BGQWK is working.  The second door just uses
  467.          BGQWK on whichever Hard Drive I tell it to use (usually either the
  468.          faster one or the one that has the most space).
  469.  
  470.          Oh, and speaking of RAM disks ...  I _highly_, _highly_, _highly_
  471.          recommend using both a large RAM disk, if you have it, and a large
  472.          disk cache.  Together, they can make BGQWK fly at supersonic
  473.          speeds (well, _much_ faster than it would if you don't run a cache
  474.          or RAM disk).
  475.  
  476.          Of course, using RAM disks and disk cache's are totally up to you.
  477.          If you're not running them now, it's probably because you don't
  478.          have any extra memory lying around.  If you do, by all means, find
  479.          a disk cache and install it.  You will be amazed at how much
  480.          faster BGQWK, GT, and all your other programs run.
  481.  
  482.          Anyway, ... when BGQWK runs, it will create it's own work
  483.          directory on whatever drive you specify.  The directory will be
  484.          called \BG$WORK$\.pid, where "pid" is the current PID number of
  485.          whatever node is currently using BGQWK.  This allows multiple
  486.          nodes to use BGQWK at the same time on the same drive.  If you are
  487.          not using a LAN, the PID number will most likely by "0".
  488.  
  489.          The work directory will always be deleted when the door is exited.
  490.  
  491.  
  492.          DOOR OPTIONS
  493.          ------------
  494.          5    If specified, BGQWK will run in GT 15.50 mode and use
  495.               individual xxxxx.MSG files rather than the newer ten message
  496.               xxxxx.MES files.  BGQWK runs much slower in 15.50 mode
  497.               because it has to open and close ten times as many files, but
  498.               it will still work.  If you specify this option on a non-GT
  499.               15.50 system, the door will not work correctly.  If you do
  500.               not specify this option on a true 15.50 system, BGQWK will
  501.               not work.
  502.  
  503.          M    If specified, BGQWK will use DSZ in MobyTurbo mode.
  504.               Remember, you must have a registered copy of DSZ in order for
  505.               this to work.  If you do not, DSZ may abort because of
  506.               invalid parameters.
  507.  
  508.          G    If specified, BGQWK will allow users to select the Ymodem-G
  509.               protocol.  Remember, you must have a registered copy of DSZ
  510.               in order for this to work.  If you do not, DSZ may abort
  511.               because of invalid parameters.  Also, do not use this option
  512.               unless you have some type of error correction hardware built
  513.               into your modem (such as MNP or LAP-M).
  514.  
  515.          S    Normally, BGQWK uses DSZ in "handshake both" mode.  If this
  516.               option is specified, BGQWK will use DSZ in "handshake slow"
  517.               mode.  (If you are using HS/Link, this option will also use
  518.               HS/Link is slow handshake mode using the -HS parameter).
  519.               Only use this option if your users are having trouble sending
  520.               or receiving files through the BGQWK door.  Some older
  521.               systems have trouble with communicating over serial lines and
  522.               writing to the hard disk at the same time.
  523.  
  524.          A    Normally, BGQWK gives users the option to read the NEWS file
  525.               (GTBULLET.CBS or another file if you specified the NE=
  526.               configuration option in the BGQWK.CNF file) whenever its
  527.               updated or all the time.  If the A option is specified, BGQWK
  528.               will override the user's setting and send the NEWS option
  529.               during all download of QWK packets.
  530.  
  531.          K    Normally, any messages sent to your board through BGQWK have
  532.               either no security or a private status.  This option, when
  533.               specified, makes messages with no security change to no kill
  534.               status.  Use of this option is entirely up to you.
  535.  
  536.          H    Normally, the door will allow users to logoff from within the
  537.               door.  However, many sysops do not want this, because their
  538.               systems may be rebooted (if not using DVDOOR) or just because
  539.               they want their users to exit from the board.  This option,
  540.               when specified, will not allow users to logoff.
  541.  
  542.          R    Normally, when messages are uploaded, if their messages are
  543.               replies to other messages, the reference number may be added
  544.               to the header.  If you renumber your message bases, any
  545.               reference numbers sent through the door will be meaningless.
  546.               This option should be used only if you renumber your message
  547.               bases or if you just hate reference numbers.
  548.  
  549.          D    Normally, if a user uploads a message into an area with
  550.               improper flags (say the enter a public message in a private
  551.               only message area), the message will be moved to the sysop
  552.               message base (or general message base if a sysop message base
  553.               does not exist).  If this option is specified, in essence, it
  554.               tells BGQWK to "don't move" the messages, but leave them in
  555.               their current base, but change the message flags to an
  556.               something which is acceptable for the current conference.
  557.  
  558.          N    Normally, the user has the option to have BGQWK do a scan for
  559.               new files when they choose to download a QWK packet.  For
  560.               some reason or another, if you wish to have the file scan
  561.               disabled, simply specify this option.
  562.  
  563.          L    If you are running GT 17, normally, users may tag files, open
  564.               the BGQWK door, and download their QWK packet and tagged
  565.               files.  Of course, BGQWK does checks for sufficient time, and
  566.               updates USER.CTL with the number downloaded files and
  567.               downloaded kilobytes, but some sysops may want to disable
  568.               this feature.  That may be done with the L option.
  569.  
  570.          B    If you are running GT 17 and the current user in the door has
  571.               a proper time bank entry in the GTUSER.BBS file (TB=), BGQWK
  572.               will reward time bank credit for the number of messages
  573.               downloaded (if you specify how many credits received for each
  574.               message downloaded) and will deduct credit for any tagged
  575.               files downloaded.  If you wish for this feature to be
  576.               disabled, simply specify the B option on the command line.
  577.  
  578.          Please note that when specifing options, no matter how many
  579.          options you wish to use, they must be specified in a "squeezed"
  580.          format, like so:
  581.                         ┌─── command line options
  582.               bgqwk mgskhrlb d:
  583.                              └─── work drive
  584.  
  585.          You may not want to use any command line options at all.  If not,
  586.          simply use a "dot" as the options, like so:
  587.  
  588.               bgqwk . c:
  589.  
  590.          That would cause BGQWK to run with all defaults and use drive C:
  591.          as the work drive.
  592.  
  593.          -------------------------------------------------------------
  594.          THE DOOR ITSELF
  595.          -------------------------------------------------------------
  596.  
  597.          BGQWK has internal commucations routines so external drivers such
  598.          as GATEWAY or DOORWAY are not needed.
  599.  
  600.          BGQWK also has an internal ANSI driver, so the sysop need not run
  601.          ANSI.SYS in order to see color on the bulletin board end.  ANSI
  602.          music will not be played.  The users will not be able to beep you
  603.          with the Control-G key.
  604.  
  605.          The COM port being used is taken out of the GT.CNF file under the
  606.          CM= directive.  The DTE and DCE BPS rates are taken from the
  607.          GTUSER.BBS file.  The COM port is opened at the DTE rate, and
  608.          estimates are based off the DCE rate.
  609.  
  610.          BGQWK constantly checks the COM port for a CARRIER DETECT
  611.          indicator.  If carrier is lost, BGQWK will return to the board
  612.          where GT will log the user off.
  613.  
  614.          If a user selects G)oodbye from within the door, DTR is dropped
  615.          until CD is low, then DTR is raised and BGQWK will then return to
  616.          the board where GT will log the user off.
  617.  
  618.          If there is no input within four minutes, the door will
  619.          automatically return to GT.
  620.  
  621.          BGQWK offers Xmodem, Ymodem, Ymodem Batch and Zmodem at all times
  622.          using the DSZ protocol driver.  Be sure a DSZ protocol driver is
  623.          located somewhere in your DOS PATH.  First, GSZ.EXE will be
  624.          searched for.  If not found, DSZ.EXE will be searched for.  If not
  625.          found, DSZ.COM is searched for.  If not found then, BGQWK will
  626.          abort.  To enable Ymodem-G, see the "G" command line option.
  627.  
  628.          Paul Meiners' external Zmodem driver, GTZ, is not supported.
  629.  
  630.          BGQWK will also search for Sam Smith's HSLINK.EXE program in your
  631.          DOS PATH.  If found, BGQWK will allow your users to optionally use
  632.          the HS/Link high speed bi-directional protocol so they can
  633.          download QWK packets and upload REP packets at the same time.
  634.  
  635.          When a user is in the door, a simple chat mode can be activated
  636.          from the sysop end by the Control-P key.  A shell to DOS can be
  637.          performed using the Alt-1 key.  (Please note that the shell is
  638.          directly from BGQWK, not DOOR.EXE or TDOOR.EXE.  You will have a
  639.          very limited amount of memory to work with).
  640.  
  641.          -------------------------------------------------------------
  642.          MODES OF OPERATION
  643.          -------------------------------------------------------------
  644.  
  645.          Normally, BGQWK works as a logon door, but it can also prepack QWK
  646.          packets so that users can call, and download the packets from
  647.          inside GT rather than having to wait for the door to load and pack
  648.          up new messages.
  649.  
  650.               @echo off
  651.               rem -- this batch file runs as an event during some time
  652.               bgqwk n f: /pp:John Doe
  653.               copy c:\gt\specreq\tranquil.qwk c:\gt\uploads\forjohn.zip
  654.  
  655.          Prepack mode is specified by a third parameter, /PP.  If you ever
  656.          choose to do this, which I recommend only to experienced sysops,
  657.          the user name following the /PP: must be used.
  658.  
  659.          The QWK packet made will be placed in the sysop's default download
  660.          directory.  It is up to the sysop to place (and rename) the QWK
  661.          packet in a directory where the user can access it.  In the above
  662.          sample batch file, I have an event at time xx:yy where GT exits,
  663.          runs BGQWK in prepack mode for John Doe and renames his
  664.          TRANQUIL.QWK packet to FORJOHN.ZIP into the new uploads directory.
  665.  
  666.          In both local mode operation and prepack mode operation, any
  667.          "downloads" are placed into the sysop's download directory.
  668.          CARRIER DETECT is not monitored and no data is sent or received
  669.          from the COM port.
  670.  
  671.          In local mode, the sysop can experiment with BGQWK.  If he or she
  672.          chooses to "upload" a REP packet, it must be placed in the sysop's
  673.          outgoing uploads directory for BGQWK to find it.  Just a reminder
  674.          that the sysop's download directory is specified by TP= in the
  675.          GT.CNF file and the sysop's upload directory is specified by the
  676.          UP= in GT.CNF).
  677.  
  678.          -------------------------------------------------------------
  679.          NET STATUS
  680.          -------------------------------------------------------------
  681.  
  682.          If you aren't interested in QWK networking, you can skip over this
  683.          section of the documentation.
  684.  
  685.          I bet this is the part a couple of people were waiting for.  There
  686.          is another universe out there in BBS message networking than that
  687.          based off of the MDRIVER concept.  Well, yes, there is that
  688.          universe based off of Kip Compton's UTI concept, but now, on any
  689.          GT Power board, we can now pick up any network that is based off
  690.          of the QWK packet standard.  The Networks available include
  691.          SmartNet, ILink, TexasNet (for Texas residents), and a whole mess
  692.          of other networks.
  693.  
  694.          In order to participate in these networks, you must first download
  695.          another piece of software--TNET21.ZIP by Greg Hewgill--but we'll
  696.          get into that later.
  697.  
  698.          Granting Net Status to Users
  699.          ----------------------------
  700.          First of all, let's take another look at my BGQWK.CNF file posted
  701.          a while ago.
  702.  
  703. ns=John Doe/gt
  704. ns=Node Houston/tx
  705. ns=Jimmy Dean/rn gt
  706.  
  707.          There were three NS= entries in the configuration file.  That is
  708.          okay.  NS= is the only directive that can be repeated.  Let's talk
  709.          about what each of those entries mean.
  710.  
  711.          If "John Doe" opens the BGQWK door, he will be granted "net
  712.          status" in any conference that has a net id of "GT".
  713.  
  714.                         ┌─── net id
  715. 015 | z | Gfx Proj   | rn=D:\MAIL\RNET261
  716. 040 | 0 | Netmail    | lo=D:\MAIL\NETMAIL,N
  717. 041 | z | AnsiArt    | gt=D:\MAIL\E10-037,P
  718. 039 | z | Bg Qwk     | gt=D:\MAIL\E02-758,P
  719.                         └─── net id
  720.  
  721.          Look at this short section from the configuration file.
  722.          "John Doe" would be granted net status in conference 41 and
  723.          conference 39.
  724.  
  725.          If "Node Houston" opens the BGQWK door, it will be granted "net
  726.          status" in any conference that has a net id of "TX".
  727.  
  728.          If "Jimmy Dean" opens the BGQWK door, he will be granted "net
  729.          status" in any conference that has a net id of "RN" _or_ "GT".
  730.  
  731.          What in the world does "granted 'net status'" mean?  Well,
  732.          remember QWK is a very universal format.  We don't want some user
  733.          like "Joe Blow" downloading mail from all my conferences and
  734.          inserting it into his PC Board without the sysop's permission, do
  735.          we?  So, if "Joe Blow" tries to do this with his QWK networking
  736.          software (such as TNet or QNet), he will get an error message, and
  737.          out precious GT Network messages are safe.  However, if you are
  738.          the GT LNC of your city, you may want to give "Joe Blow" net
  739.          status authorities in your GT Network conferences.  In essence,
  740.          "Joe Blow" will become net/node xxx/yyy in the GT Network with his
  741.          PC Board system.  At present, sending netmail back and forth along
  742.          a QWK network is not supported, but experimental bagging
  743.          techniques are being used between 001/040 and 001/070.  If the
  744.          tests are successful, the batch files will be released.
  745.  
  746.          Having "net status" also means having more significant control as
  747.          to what kinds of messages can be downloaded and uploaded in a
  748.          conference that a user has net status access to.  Any private
  749.          messages in a conference can be downloaded, and the "net status"
  750.          user can upload messages addressed from other people.  (Meaning
  751.          "Node Houston" can upload messages from "Russell Kroll", for
  752.          example).  A regular user cannot download private mail unless it
  753.          is addressed to them or left by them and can only upload mail in
  754.          their own name.
  755.  
  756.          Remember, giving someone net status is a PRIVLEDGE.  It should not
  757.          be given to just anybody.  You have to be responsible.
  758.  
  759.          Another Sysop Granting Net Status to YOU
  760.          ----------------------------------------
  761.          Ok, calm down, I can hear you!  You want to know how to pick up
  762.          those other networks such as SmartNet, ILink, etc., don't you?
  763.  
  764.          This is what you have to do...  First, you need to get in contact
  765.          with the head hancho of the QWK network in your area.  You'll
  766.          probably have to apply in order to get accepted or rejected.  It
  767.          will be a lot of waiting until they get back to you.  If you are
  768.          accepted, you'll probably be assigned a hub to use.  More than
  769.          likely, your hub will be a PC Board system.  You'll need to write
  770.          a script for GT Power (or some other communications software) that
  771.          will login, open the QMail Markmail (or whatever) door, upload a
  772.          REP packet (if exists), download a QWK packet, and then logoff.
  773.  
  774.          The sysop of the other board _must_ have granted you net status in
  775.          the conferences you wish to pick up or the QWK packet you download
  776.          will not be able to be imported into your board.
  777.  
  778.          So how do you make REP packets to send to that board and what do
  779.          you do with the QWK packet once you download it?  Do you use BGQWK
  780.          to do that function?  No.  That's why I included all those UTI
  781.          files.  TNet is what you need to use.  Because TNet was written by
  782.          Wildcat! (and not GT), it was pretty much useless to us a few
  783.          months ago, but since then, Greg Hewgill has released a version of
  784.          TNet that works with UTI drivers.
  785.  
  786.          If you plan to use TNet, there are a couple of miscellaneous
  787.          things you need to know:
  788.  
  789.          In the TNET.CFG file, you'll need the following lines (and other
  790.          things that the TNET.DOC file explains) ...
  791.  
  792. SYSTEM      = UTI2
  793. APPEND      = Y
  794.  
  795.          ... and when specifing conferences, you need to put a dollar sign
  796.          in front of the path in the other .CFG files ...
  797.  
  798. CONF        = $D:\MAIL\TNET001
  799.  
  800.          ... and finally ...  In the mail door on the system you are
  801.          connecting to download your mail, you may want to set "download
  802.          packets with zero messages" to TRUE or YES.  Why would you want to
  803.          do that?  Well, the way my batch files are set up, if I find a QWK
  804.          file in my downloads directory after a mail run, the batch files
  805.          will assume the mail run was successful.  If not, it will assume
  806.          the run was a failure and will not delete the .REP file when done,
  807.          so that it can be uploaded again the next day (since it probably
  808.          wasn't the firs time).
  809.  
  810.          I currently use TNet and my UTIs to pick up mail in the TexasNet
  811.          network off of Ed Hopper's BBS and a few of the conferences from
  812.          the GT Network off of Russell Kroll's Computech BBS.
  813.  
  814.          See the TNET.DOC file in the TNET21.ZIP file available on my board
  815.          as well as many others for further information.  Alternatively,
  816.          you may still join other QWK based networks using Dave Wall's
  817.          MERLIN prorgram (written specifically for GT Power).  The concept
  818.          is pretty much the same.
  819.  
  820.          And one last thing:
  821.  
  822.          I give the user of this software permission to use my UTI drivers
  823.          with whatever software they choose to use that works with it.
  824.  
  825.          -------------------------------------------------------------
  826.          ACKNOWLEDGEMENTS
  827.          -------------------------------------------------------------
  828.  
  829.          I would like to thank the following people for their assistance
  830.          during the beta test phase.
  831.  
  832.          John Albrecht       Michael Arnett      Ted Arsovsky
  833.          Oliver Bell         Ovid Bilderback     Richard Blackburn
  834.          Chris Carpenter     Bill Coady          James Davis
  835.          Cam Deduck          Marcos Della        Eddie Dodwell
  836.          Ed Ester            John Ferra          John Fisher
  837.          Mike Foshee         Mike Frisch         John Glover
  838.          James Gunnells      Theresa Hadden      Ted Harper
  839.          Jack Hazel          Greg Hewgill        Reginald Hirsch
  840.          Jerry Hook          Ed Hopper           Dennis Ivy
  841.          Rathulvf Jamesson   Don Jones           Wayne Jones
  842.          Mike King           Ken Kirkland        Mark Kofahl
  843.          Jim Kreyling        Russell Kroll       Rudi Kusters
  844.          Warren Leadbeatter  David Logan         Bruce Lloyd
  845.          Ed Lucas            Dan Mancuso         Jeremy Mattern
  846.          Michele Mauro       Mark May            Andy Mcclung
  847.          Mike Meyer          John Moody          Gene Newcomb
  848.          Mike Olah           George Omoregie     Ken Opdycke
  849.          Patrick Perea       Douglas Pippel      Sam Prater
  850.          Roy Salisbury       Paul Schwarz        Joe Separk
  851.          Robert Smathers     Laurence Stanley    David Stellmack
  852.          Bill Thomas         Roger Thompson      Charles Vancleef
  853.          Frank Vlamings      Bill Wahlstrom      Richard Walker
  854.          Dave Wall           Stephen Weihman     Scott Wills
  855.            and Brian Wood
  856.  
  857.          I've tried not to forget anyone, but my memory is a little
  858.          flakey sometimes.
  859.  
  860.          -------------------------------------------------------------
  861.          OTHER INFORMATION
  862.          -------------------------------------------------------------
  863.  
  864.          The XT version of this program was compiled under Borland's Turbo
  865.          Pascal 5.5.  The AT version was compiled under Turbo Pascal 6.0.
  866.  
  867.          All EXE files are compressed with DIET, the exciting file slimming
  868.          exerciser.
  869.  
  870.          This program is SHAREWARE.  If you use this program for more than
  871.          four weeks, it is _highly_ recommended you register the program
  872.          at it low cost of only US $25.  I have put hundreds of hours of
  873.          time into BGQWK and registrations encourage frequent updates.
  874.          If you choose to register after the trial time period, please fill
  875.          out the included REGISTER.FRM file and send it along with your
  876.          check or money order.  After allowing two weeks for processing,
  877.          you can call my bulletin board at 713-893-9124 (now operating with
  878.          V.32, V.42 and V.42bis) and open the QWKREG door.  A BGQWK.KEY
  879.          file will then be generated that will register your copy of BGQWK.
  880.          The call takes less than three minutes.
  881.  
  882.          The UNREGISTERED version of this software is NOT CRIPPLED.
  883.  
  884.          If you have any suggestions, comments or questions, please address
  885.          them to the "BG Reader, Etc." GT Network echomail conference,
  886.          E02/758.  Feel free to call my board or to call voice (decent
  887.          hours and ask for B.J., please).
  888.  
  889.          <Plug> Have you seen my two successful FREEWARE programs?  Why
  890.          don't you pick up a copy of BGTOP and BGWHO?  Pretty neat stuff!
  891.  
  892.          Regards,                                         GT:  E02/758
  893.          B.J. Guillot                                   RIME: TRANQUIL
  894.